home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / printing / jacket17.arc / JACKET17.TXT < prev    next >
Text File  |  1992-04-01  |  8KB  |  188 lines
  1.                         Disk Jacket  v1.7
  2.                      =======================
  3.  
  4.                       By Kenneth W. Hartlen
  5.  
  6.                           April 1,1992
  7.  
  8.  
  9.      Disk Jacket v1.7 scans a disk drive and saves the first  129 
  10. file names,  sorts them by directory and filename, and prints a 3 
  11. 1/2" or 5 1/4" jacket with the directory and file names listed on 
  12. it. A jacket name, current date and available disk space are also 
  13. printed  on the jacket.  If you regularly give your disks  volume 
  14. names,  Disk  Jacket  v1.7 can use the disk volume name  for  the 
  15. jacket name.
  16.  
  17.      My  original purpose for writing this program was to have  a 
  18. file list for disks that contained source code and documents  for 
  19. my university courses. By simply flipping through my disks I knew 
  20. what  was  on  them without needing to use  my  computer.  Now  I 
  21. usually print a jacket for master disks,  for ST FORMAT, Atari ST 
  22. User and STart magazine disks,  etc.  Now I can easily locate the 
  23. files and programs I need.
  24.  
  25.      Friends expressed an interest in this utility,  so I thought 
  26. I'd  share it with others.  I wrote the program in C and  the  ST 
  27. version was compiled using Lattice C v5.06 and the PC version was 
  28. compiled using Turbo C v2.0.
  29.  
  30.  
  31.                           JACKET17.ARC
  32.                          ==============
  33.  
  34.      The  archive file JACKET17.ARC contains the  required  files 
  35. for  using  Disk Jacket v1.7 on an Atari ST or an  PC  compatible 
  36. computer.
  37.  
  38. JACKET.TTP     The  ST version of the Disk Jacket  v1.7  program. 
  39.                Run from GEM, NeoDesk or a CLI.
  40. JACKET.EXE     The  PC version of the Disk Jacket  v1.7  program, 
  41.                run from MS-DOS.
  42. JACKET.CFG     The printer configuration file.
  43. LQ2500.CFG     Configuration file for Epson LQ2500 printer.
  44. JACKET17.TXT   This file.
  45. JACKET.NIC     NeoDesk v3.02 icon file containing an icon for the 
  46.                ST version of the Disk Jacket v1.7 program.
  47.  
  48.      If any of these files are missing, the original JACKET17.ARC 
  49. file has be tampered with.  Please locate a complete JACKET17.ARC 
  50. file.
  51.  
  52.  
  53.                       Using Disk Jacket v1.7
  54.                      ========================
  55.  
  56.      To  run  the  program on  an  ST,  simply  double-click  the 
  57. JACKET.TTP icon in GEM or NeoDesk.   Since the program is a .TTP, 
  58. you will be prompted for parameters.  When run from a CLI on a ST 
  59. or  from MS-DOS on a PC,  you must specify  the  parameters.  The 
  60. program usage is: jacket [-ab35ldsvu] [name]
  61.  
  62.      Here is a list of legal options:
  63.  
  64.        -a      process drive A (*)
  65.        -b      process drive B
  66.        -3      create 3.5" disk jacket (*)
  67.        -5      create 5.25" disk jacket
  68.        -l      use letter quality font
  69.        -d      use draft quality font (*)
  70.        -s      suppress progress messages
  71.        -v      use NeoDesk, TOS or MS-DOS volume name (*)
  72.        -u      use user's jacket name
  73.        [name]  user specified jacket name
  74.  
  75.      Note:     (*)  indicates  the  default  options  used   when 
  76.                parameters are not specified.
  77.  
  78.      If the -v option is used,  Disk Jacket v1.7 searches for the  
  79. NEODESK.DAT file,  if not found the disk TOS/DOS volume name will 
  80. be searched for,  and if neither was found a the jacket name will 
  81. not have a name. If you want to use your own jacket name, use the 
  82. -u option and make sure the jacket name is the last parameter and 
  83. enclose the name in double quotes if it contains spaces.
  84.  
  85.      Disk Jacket v1.7 will return one of two exit codes:
  86.  
  87.       0:  the program terminated normally.
  88.      -1:  an illegal parameter is encountered.  Or the printer is 
  89.           not  ready.  Or  the disk being  scaned  is  empty,  no 
  90.           directories or files. (Note: The PC version looks for a 
  91.           printer on the LPT1 port).
  92.  
  93. Note:     ST   users  creating  jackets  for   disks   originally 
  94.           formatted  on  an  PC compatible may  notice  that  the 
  95.           volume  name may appear on the jacket.  This occurs  if 
  96.           the MS-DOS program LABEL.COM was used to give the  disk 
  97.           a label name. It creates a volume name but doesn't hide 
  98.           it.
  99.  
  100.      The  files  are  listed  in three  columns  on  the  jacket. 
  101. Directory names will separate the files as they exist on the disk 
  102. and  are preceded by a backslash (\).  The file names are  listed 
  103. top to bottom since it is easier to see the directory  structures 
  104. these  way.  The  program searches subdirectories  and  ST  users 
  105. should  keep the 40-folder limit bug in mind and ensure  a  patch 
  106. has been loaded before running Disk Jacket v1.7.
  107.  
  108.      After  the  jacket is printed it must be  finished  by  you. 
  109. Simply  cut out and fold the jacket as instructed,  then tape  it 
  110. together  (I prefer using a UHU Stic glue stick).  The jacket  is 
  111. now  ready  to accept your disk.  Since most of the time  3  1/2" 
  112. jackets  will  be printed,  you can save  paper  by  cutting,  or 
  113. folding,  single  sheets into 5 1/2" by 8 1/2" sheets and  single 
  114. feeding them lengthways into the printer.  I have a Panasonic KX-
  115. P1124 with front paper feed so this is convenient.
  116.  
  117.      Now  finding that file in a box of disks should be a  little 
  118. easier and you won't have to power up your computer to do it.
  119.  
  120.  
  121.                      The  Configuration File
  122.                     =========================
  123.  
  124.      Since each model of printer will have different setup codes, 
  125. the  Disk Jacket v1.7 program reads a configuration  file  called 
  126. JACKET.CFG which must contain the control codes for your printer. 
  127. If  JACKET.CFG can not be found,  Epson LQ2500 defaults  will  be 
  128. used. I've supplied a configuration file for the Epson LQ2500 and 
  129. you can easily create your own, if necessary.
  130.  
  131.      The  JACKET.CFG file must have the following format and  can 
  132. be modified using any text editor.  All values must be  separated 
  133. by at least one space and be the decimal for the printer code.
  134.  
  135. Line 1: Disk Jacket Printer Configuration Codes, Epson LQ2500
  136. Line 2: 003 027 103 015                 /* 15cpi, Micron mode */
  137. Line 3: 003 027 065 007                 /* 7 60th spacing */
  138. Line 4: 003 027 120 001                 /* letter quality font */
  139. Line 5: 001 012                         /* printer form feed */
  140. Line 6: 002 027 064                     /* printer reset */
  141.  
  142. Line 1:   Simply holds a comment for your purposes and is ignored 
  143.           by the Disk Jacket v1.7 program.
  144. Line 2-6: These lines contain the printer codes that your printer 
  145.           recognizes.  The  first number is the number of  values 
  146.           that follow.  Then up to ten control values,  separated 
  147.           by  spaces,  will  be read.  Again a comment  for  your 
  148.           purposes at the end of the line is ignored.
  149.  
  150.      If Disk Jacket v1.7 is not changing the cpi or lpi  settings 
  151. on  your printer,  check to make sure your printer is set  so  it 
  152. will accept software control codes.  If the 3 1/2" jacket is  too 
  153. small or too large, make sure the the cpi is being set to 15cpi.
  154.      
  155.  
  156.                       Disclaimer and Notes
  157.                      ======================
  158.  
  159.      Disk  Jacket v1.7 is freeware,  meaning JACKET17.ARC can  be 
  160. distributed  freely  (unmodified) and there is no cost to  own  a 
  161. copy.  Disk Jacket v1.7 is provided AS IS.  I make no warranties, 
  162. either expressed or implied,  with respect to the  software,  its 
  163. quality,  performance,  or  fitness.  I  will not be  liable  for 
  164. direct,  indirect,  or  consequential damages resulting from  any 
  165. defects in the software.
  166.  
  167.      Having said that, I hope you find Disk Jacket v1.7 as useful 
  168. as I do.
  169.  
  170.      Suggestions to improve Disk Jacket v1.7,  or if any bugs are 
  171. encountered,  or  if you'd like to send $ (yeah,  right!) can  be 
  172. reported to myself:
  173.  
  174.           Kenneth W. Hartlen
  175.           Box 37, Site 6, RR#3
  176.           Armdale, Nova Scotia
  177.           Canada B3L-4J3
  178.  
  179.      Please  send a self-addressed stamped envelop if  you  would 
  180. like me to reply.
  181.  
  182.      I  can  also  be reached by  e-mail  (until  the